home *** CD-ROM | disk | FTP | other *** search
/ Acorn User: China / Acorn User China CD-ROM (UK) (Disc B) / Acorn User China CD-ROM (UK) (Disc B).bin / STUTTGART / MATHS / EVAL / !Eval_!ReadMe next >
Encoding:
Text File  |  1989-12-09  |  4.7 KB  |  109 lines
  1.                        Documentation for EVALuator V1.00
  2.                        ---------------------------------
  3.  
  4. ********************** Incredibly boring Copyright Notice *********************
  5. *                                                                             *
  6. *       All program code is the exclusive copyright of Richard K. Lloyd.      *
  7. *            The program source and documentation for EVALuator are           *
  8. * freely distributable and should not be charged for under ANY circumstances. *
  9. *                                                                             *
  10. *******************************************************************************
  11.  
  12. Installing EVALuator (Requires RISC OS)
  13. ---------------------------------------
  14.  
  15. Simply start up the Desktop and double-click on the !EVALuator application
  16. directory. This will install an icon on the RHS of the icon bar, ready for
  17. running by clicking on this icon with the left or right button. The middle
  18. button just brings up the usual Info and Quit options which need no further
  19. explanation here.
  20.  
  21. So what does EVALuator do ?
  22. ---------------------------
  23.  
  24. People who spend all their time in the Desktop (I don't for programming, but
  25. that's just me folks) often, OK sometimes, wonder why they need BASIC at all.
  26. Well, other than the fact that its used as the main language for an *awful lot*
  27. of PD (and commercial !) Desktop programs, it's a great 'quickie expression
  28. evaluator'.
  29.  
  30. However, there is a drawback: to stop BASIC destroying all the currently active
  31. Desktop programs, you must use the awkward 'New Task' option in the Task
  32. Manager and up pops a miserly window and all your tasks suspend whilst you're
  33. in BASIC...all this for a miserly PRINT PI^2.8 or some such calculation !
  34. Hence, it's RKL to the rescue again with a Desktop application which calls
  35. EVAL itself in a nice friendly multi-tasking window.
  36.  
  37. How To Run EVALuator
  38. --------------------
  39.  
  40. When you click on the icon bar icon, up pops a small window with two main
  41. areas: 'Expression' (click on the white area to display a caret) and 'Result'
  42. (this cannot be edited - there's no point...or even a caret). Once clicked on,
  43. the Expression area allows the usual mouse/key actions (click, delete, CTRL-U
  44. etc.) and the evaluation (passed to EVAL) of the expression is displayed IN
  45. REAL-TIME in the Result area (hence you don't have to press RETURN).
  46.  
  47. If the Expression is a null string, then "No expression" is displayed in the
  48. Results area. If the Expression begins with a tilde (~), then the Result is
  49. shown in hexadecimal and prefixed with an ampersand (&). The Expression area
  50. allows up to 99 characters, although it is much narrower than that to reduce
  51. the overall window size - the input area scrolls automatically if you type
  52. an extremely long expression.
  53.  
  54. Technical Details of Evaluator
  55. ------------------------------
  56.  
  57. Well, there's no a lot to say here. I originally developed the program on
  58. a Macintosh Plus as a DA (using Turbo Pascal and...groan...my OWN expression
  59. evaluator closely modelled on BBC BASIC's) and then on a MicroVAX II using
  60. VAX Pascal (and you could assign/read DCL variables !). The program's one hell
  61. of a lot shorter with the use of the wondrous EVAL.
  62.  
  63. Some moans to Acorn about the WIMP and !FormEd:
  64.  
  65. 1. !FormEd is a right pain to use when you want to adjust the size of an icon.
  66.    You have to *change* the icon's attributes to Click/Drag, do the adjustment
  67.    with the right button and then set it back again ! AAARRRGGGHHH !!
  68.    Windows can't be resized unless you add a V Scroll (inc. Size Icon) - not
  69.    even the right button works...
  70.  
  71. 2. Can anyone please tell me how to stop Wimp_ForceRedraw from completely
  72.    ignoring the video refresh and flickering nastily when it updates the
  73.    area specified ? No, putting a WAIT (*FX 19) before it doesn't work.
  74.  
  75. 3. Why isn't the line number reported by errors in BASIC programs once they've
  76.    done a Wimp_Initialise ?
  77.  
  78. 4. Why doesn't a keypress inside a writeable icon return anything back via
  79.    Wimp_Poll (specifically Event 8) ?
  80.  
  81. Revision History of EVALuator
  82. -----------------------------
  83.  
  84. Version 1.00
  85. ------------
  86.  
  87. * A very quickly cobbled together BASIC Desktop program that replaces the need
  88.   to run BASIC just do a calculation using the PRINT statement.
  89.  
  90. Future Improvements to EVALuator V1.00
  91. --------------------------------------
  92.  
  93. * I'd like an resizeable window that would automatically resize the Expression
  94.   and Result areas too.
  95.  
  96. * Some sort of cut/paste facility (does the Archimedes have a Clipboard - I
  97.   don't think so).
  98.  
  99. Where to find me to report bugs or improvements to the EVALuator
  100. ----------------------------------------------------------------
  101.  
  102. Snail Mail           JANET e-mail
  103. ----------           ------------
  104. Richard K. Lloyd,    rkl@uk.ac.liv.cs.mva
  105. 1, Banks Road,
  106. Lower Heswall,
  107. Wirral,
  108. Merseyside. 
  109.